(for Internet Explorer)
← ▼ ▲
↑
Function  DicTable( DataArray as array ) as array of Dictionary
テーブルのように使う、辞書の配列を生成します。
関連
(src)
サンプル
    For Each  t  In DicTable( Array( _
        "Item",  "Price",  "Number",   Empty, _
        "Book",     2000,         2, _
        "Pen",       100,        12, _
        "Eraser",     60,        10 ) )

        echo  t("Item") &" : "& t("Price") * t("Number")
    Next
１行目は、辞書のキー（属性名）を並べ、行末は Empty にします。
２行目以降は、辞書のアイテム（値）を並べます。
値には、配列やオブジェクトも指定できます。
上記を実行した結果の出力は、下記のようになります。
Book : 4000
Pen : 1200
Eraser : 600
→ JSON (JavaScript Object Notation)
辞書の内容を見るには、echo o で出力するか、?GetEchoStr( t )
をイミディエイトウィンドウで実行します。
?GetEchoStr( t )
"Item=Book
Price=2000
Number=2"
→ T_Dic.vbs
テスト
T_DicTable
デバッグのために一時的に途中から始めるときは、スキップするデータを For の上に移動し、
次のように Array を使ってダミーの配列を作成すれば無効化できます。
Array _
        "Book",     2000,         2, _
        "Pen",       100,        12, _
0 : Skipped

    For Each  t  In DicTable( Array( _
        "Item",  "Price",  "Number",   Empty, _
        "Eraser",     60,        10 ) )

        echo  t("Item") &" : "& t("Price") * t("Number")
    Next
Array _
0 :
Key, Item
*
in_Item
*
データ構造
 ← ▼ ▲
Function  JoinDicTable( DicTable1 as array of Dictionary,  KeyField as string,
                        DicTable2 as array of Dictionary ) as array of Dictionary
２つのテーブル（辞書の配列）を、指定のフィールドが一致する行で、結合します。
サンプル
table1 = DicTable( Array( _
   "Item",  "Price",  Empty, _
   "Book",     2000, _
   "Pen",       100, _
   "Eraser",     60  ) )

For Each t  In JoinDicTable( table1, "Item", Array( _
   "Item",  "Number",   Empty, _
   "Book",         2, _
   "Pen",         12, _
   "Eraser",      10 ) )

  echo  t("Item") &" : "& t("Price") * t("Number")
Next
【引数】
DicTable1
KeyField
テーブル（辞書の配列）
比較するフィールド名（辞書のキー）
DicTable2
テーブル（辞書の配列）
結合後のテーブル（辞書の配列）
返り値
(src)
For Each t  In DicTable( Array( _
   "Item",  "Price",  "Number",   Empty, _
   "Book",     2000,         2, _
   "Pen",       100,        12, _
   "Eraser",     60,        10 ) )

  echo  t("Item") &" : "& t("Price") * t("Number")
Next
上記の結合をした結果は、下記と同じです。
Item
Item
Item
JoinDicTable
関連
→ SQL の JOIN の詳細
KeyField を持ち、KeyField が Empty ではない行について、SQL の FULL OUTER JOIN
演算を行います。
テスト
→ T_Dic.vbs # T_DicTable
 ← ▼ ▲
Sub  GetDicItem( in_Dictionary  as dictionary,  in_Key  as string,  out_Item  as variant )
    GetDicItem  dic, "key1", item  '// Set "item"
    If IsEmpty( item ) Then _
        Set item = new ItemClass : item.Name = "key1"
登録されていない Key を指定したときは、out_Item = Empty になります。
このとき、値が Empty の要素を in_Dictionary 引数に指定した辞書に追加しません。
キーが登録されていることと、キーのアイテムが Empty ことの区別をするときは、Dictionary::Exists
を使ってください。
キーに対応するアイテムを取得します。
【引数】
Dic
Key
辞書
辞書のキー
out_Item
（出力）辞書のアイテム （オブジェクト または 非オブジェクト）
テスト
→ T_Dic.vbs
サンプル
辞書からアイテムを取得するときの
です。
T_GetDicItem
ソース
→ vbslib.vbs
関連
アイテムがオブジェクトでも非オブジェクトでもエラーが発生しないで、アイテムを取得できます。
下記のどちらかのコードに相当します。
out_Item = in_Dictionary( in_Key )
Set out_Item = in_Dictionary( in_Key )
 ← ▼ ▲
Sub  GetDicItemOrError( in_Dictionary  as Dictionary,  in_Key  as string,  out_Item  as variant,
    in_DictionaryName  as string )
指定したキーが登録されていなければエラーになる
です。
エラーメッセージは、下記のようになります。
【引数】
in_Dictionary
in_Key
辞書
辞書のキー
out_Item
（出力）辞書のアイテム （オブジェクト または 非オブジェクト）
テスト
→ T_Dic.vbs
T_GetDicItem
ソース
→ vbslib.vbs
関連
in_DictionaryName
辞書を特定するためにエラーメッセージに表示する辞書の名前
<ERROR msg="見つかりません"  name="Last"  in="検索結果"/>
    GetDicItem  dic, "Last", item, "検索結果"  '// Set "item"
サンプル
 ← ▼ ▲
Function  DicItem( Dic as Dictionary, Key as string ) as variant
登録されていないときも、新規に登録しない、
です。
dic.Item("key1")
DicItem( dic, "key1" )
Dictionary::Item では
DicItem では
登録されていないときは、Empty を返します。
(src)
テスト
→ T_Dic.vbs # T_GetDicItem
 ← ▼ ▲
Sub  GetDicItemByIndex( in_Dictionary as dictionary, in_IndexNum as string, out_Item as variant )
番号で辞書のアイテムを参照します。
番号が大きすぎるか小さすぎるときは、out_Item = Empty になります。
【引数】
in_Dictionary
in_IndexNum
辞書
キーの番号。 0 以上、キーの数未満
out_Item
（出力）辞書のアイテム
in_IndexNum 引数に指定する値は、in_Dictionary.Keys で取得できるキーの集合の順番に対応します。
  GetDicItemByIndex  dic, 0, item  '// Set "item"
サンプル
→ vbslib.vbs
ソース
T_GetDicItem
テスト
→ T_Dic.vbs
関連
 ← ▼ ▲
Function  DicItemOfItem( Dic as Dictionary, Key as string ) as variant
辞書の Item が $ か % で囲んだ変数なら、それを Key とした Item を返します。
  Set  dic = CreateObject( "Scripting.Dictionary" )
  dic.Item( "Key1" ) = "$Key3"
  dic.Item( "Key2" ) = "%Key3%"
  dic.Item( "Key3" ) = "Item3"

  Assert  DicItemOfItem( dic, "Key1" ) = "Item3"
  Assert  DicItemOfItem( dic, "Key2" ) = "Item3"
  Assert  DicItemOfItem( dic, "Key3" ) = "Item3"
サンプル
辞書の Item が % か  で囲んだ変数ではないなら、辞書の Item をそのまま返します。
(src)
→ T_Dic.vbs # T_DicItemOfItem
テスト
関連
 ← ▼ ▲
Sub  Dic_addElem( ref_Dictionary  as dictionary,  in_Key  as string,  in_Item  as variant )
辞書に要素（キーと値）を追加します。
【引数】
ref_Dictionary
in_Key
（入出力） 編集する辞書
辞書のキー
in_Item
辞書に追加する値 （オブジェクト または 非オブジェクト）
in_Item がオブジェクトかどうかで、Set を記述するかどうかを区別する必要がありません。
in_Item が Empty のときは、ref_Dictionary からキーを削除します。
すでに指定したキーが登録されてあったときは、値を変更します。
関連
    Dic_addElem  dic, "key1", item
サンプル
→ T_Dic.vbs # T_DicAdd
テスト
ソース
→ vbslib.vbs
 ← ▼ ▲
Sub  Dic_addElemOrError( ref_Dictionary  as dictionary,  in_Key  as string,  in_Item  as variant,
    in_DictionaryName  as string )
【引数】
ref_Dictionary
in_Key
（入出力） 編集する辞書
辞書のキー
in_Item
辞書に追加する値 （オブジェクト または 非オブジェクト）
指定したキーがすでに登録されていたらエラーになる
です。
in_DictionaryName
辞書を特定するためにエラーメッセージに表示する辞書の名前
エラーメッセージは、下記のようになります。
<ERROR msg="見つかりません"  name="Last"  in="検索結果"/>
    Dic_addElemOrError  dic, "key1", item, "検索結果"  '// Set "item"
サンプル
関連
→ T_Dic.vbs # T_DicAdd
テスト
ソース
→ vbslib.vbs
 ← ▼ ▲
Sub  Dic_addUniqueKeyItem( ref_Dictionary as Dictionary, in_Key as string, in_Item as variant )
辞書の要素を追加します。 すでに同じキーがあるときは、エラーになります。
【引数】
in_out_Dic
Key
（入出力） 編集する辞書
キー
Item
辞書に追加する アイテム
ref_Dictionary.Add  in_Key,  in_Item とほぼ同じですが、違いは下記のとおりです。
・in_Item が Empty のときは、ref_Dictionary からキーを削除します。
・すでに同じキーがあるときのエラーメッセージに、そのキーが表示されます。
→ T_Dic.vbs # T_DicAdd
テスト
関連
ソース
→ vbslib.vbs
注意
の使用を推奨します。
 ← ▼ ▲
Function  Dic_addNewObject( Dic as Dictionary,
    ClassName as string, ObjectName as string, IsDuplicate as boolean ) as ClassName
指定した名前がキーになければ、その名前を付けたオブジェクトを生成し、辞書に追加します。
【引数】
Dic
ClassName
辞書。 キーが ObjectName の要素が追加される
クラス名
(src)
ObjectName
オブジェクトの名前、辞書のキーになります。
返り値
Name プロパティが ObjectName のオブジェクト
  Set objs = CreateObject( "Scripting.Dictionary" )
  Set obj = Dic_addNewObject( objs, "ClassA", "ObjectA", True )

Class ClassA
  Public  Name
End Class
すでに同じ名前のオブジェクトが辞書にあるとき、かつ、IsDuplicate = True なら追加しないで、
辞書に入っていたものを返します。 IsDuplicate = False なら E_AlreadyExist エラーになります。
辞書に無いときは、オブジェクトを生成します。
IsDuplicate
False = すでに辞書にあるときはエラーにする
→ T_Dic.vbs [T_DicAddObj]
テスト
関連
ClassName に指定したクラスに、Name プロパティ、またはメンバー変数が必要です。
内部で
を使っているので、new_ClassA 関数の定義が必要です。
g_Vers("CutPropertyM") = False

Class ClassA
  Public  m_Name
End Class
g_Vers("CutPropertyM") = False にすると、Name の代わりに m_Name を使います。
生成したオブジェクトの Name プロパティに、ObjectName 引数の値が設定されます。
サンプル
 ← ▼ ▲
Function  Dic_addFromArray( in_out_Dic as Dictionary, Keys as array of string, Items as variant )
配列を使って、辞書に追加します。
【引数】
in_out_Dic
Keys
（入出力） 加算される辞書、 Empty 可能
キーとなる文字列が入っている配列
Items
キーに対応する値、または、その配列
サンプル
Set  dic = CreateObject( "Scripting.Dictionary" )
Dic_addFromArray  dic, Array( "key1", "key2" ), True
上記は下記と同じ内容です。
Set  dic = CreateObject( "Scripting.Dictionary" )
dic.Item( "key1" ) = True
dic.Item( "key2" ) = True
dic.Item( "key1" ) = 1
dic.Item( "key2" ) = 2
上記は下記と同じ内容です。
Dic_addFromArray  dic, Array( "key1", "key2" ), Array( 1, 2 )
サンプル
→ T_Dic.vbs # [T_DicArray]
テスト
返り値
in_out_Dic と同じ
Set  dic = Dic_addFromArray( Empty, Array( "key1", "key2" ), True )
サンプル
in_out_Dic 引数に Empty を指定した場合、新規に作成した辞書を返します。
ソース
→ vbs_inc_sub.vbs
 ← ▼ ▲
Sub  Dic_addPaths( in_out_Dic as Dictionary, BasePath as string, StepPaths as array of string,
    Item as variant )
複数の相対パスをそれぞれのキーとして、辞書の要素を設定します。
【引数】
in_out_Dic
BasePath
（入出力） 編集する辞書、または、
相対パスの基準パス
StepPaths
キーとする相対パスの配列
辞書に追加する アイテム
Item
サンプル
Set files = CreateObject( "Scripting.Dictionary" )
Dic_addPaths  files, "C:\Folder", Array( "a.txt", "b.txt" ), 12
上記のコードは、下記のコードと同じ処理をします。
Set files = CreateObject( "Scripting.Dictionary" )
files( "C:\Folder\a.txt" ) = 12
files( "C:\Folder\b.txt" ) = 12
→ T_Dic.vbs # T_DicAdd
テスト
ソース
→ vbslib.vbs
 ← ▼ ▲
Sub  DicKeyToArr( Dic as Dictionary, out_Array as array of string )
Dictionary のキーを配列に変換します。
(src)
 ← ▼ ▲
Sub  DicItemToArr( Dic as Dictionary, out_Array as array of variant )
Dictionary のアイテムを配列に変換します。
(src)
 ← ▼ ▲
DicKeyToCSV
Function  DicKeyToCSV( Dic as Dictionary ) as string
Dictionary のキーを CSV に変換します。
(src)
サンプル
Set  dic = CreateObject( "Scripting.Dictionary" )
dic.Item( "Key1" ) = "Item1"
dic.Item( "Key2" ) = "Item2"
Assert  DicKeyToCSV( dic ) = "Key1,Key2"
DicKeyToCSV
ファイル：
vbslib.vbs
テスト
→ T_Dic.vbs # [T_DicKeyToCSV]
Dic に要素が１つも無いときは、"" を返します。
 ← ▼ ▲
Sub  DicToArr( Dic as Dictionary, out_Arr as array of DicElem )
Dictionary を配列に変換します。 配列の要素は DicElem 型になります。
【引数】
Dic
out_Arr
Dictionary
（出力） DicElem 型の配列。
Dic の内容を Arr に変換すると、デバッガで内容を見ることができます。
（Visual Studio 2005）
(src)
Class  DicElem
  Public  Key
  Public  Item
  Public Property Get/Let  Name  '// Key と同じ
  Public Sub  Init( a_Key, a_Item )
End Class
サンプル：
  DicToArr  dic, arr  '//[out] arr
関連
(src)
 ← ▼ ▲
Sub  DicElemArrayKeyToArr( a_DicElemArray as array of DicElem, out_Array as array of variant )
の配列から、DicElem::Key の配列を抽出します。
ソース
→ vbslib.vbs
 ← ▼ ▲
Function  IsSameDictionary( DicA as dictionary, DicB as dictionary, Option_ as integer )
    as boolean
辞書のすべての要素が等しいかどうかを判定します。
各要素は = で判定します。
Option_ 引数
c は g_VBS_Lib の返り値です。
c.CompareOnlyExistB
DicB に存在する要素のみ比較します
c.StopIsNotSame
デバッグ用。 異なる要素が見つかったら、本関数の
中から Stop 命令を呼び出す
ソース
→ T_Dic.vbs
テスト
→ vbslib.vbs
T_IsSameDictionary
【引数】
DicA
DicB
DicB と比較する辞書
DicA と比較する辞書
Option_
オプション（下記）
辞書のすべての要素が等しいかどうか
返り値
 ← ▼ ▲
Sub  Dic_add( in_out_Dic as Dictionary, PlusDic as Dictionary )
辞書を加算します。
【引数】
in_out_Dic
PlusDic
（入出力） 加算される辞書
加算する内容が入っている辞書
PlusDic にあるキーがすでに in_out_Dic にあるときは、上書きします。
PlusDic のアイテムが Empty のキーは、in_out_Dic から削除されます。
そのキーが in_out_Dic にないときは、何もしませんし、エラーにもなりません。
値が Empty の変数を in_out_Dic に指定すると、内部で辞書を生成します。
→ T_Dic.vbs # T_DicAdd
テスト
関連
  Set  dic  = Dict(Array( "Key1","Item1", "Key2","Item2" ))
  Dic_add  dic, Dict(Array( "Key2","ITEMS", "Key3","Item3" ))  '//[out] dic
  Assert  dic.Count = 3
  Assert  dic.Item( "Key1" ) = "Item1"
  Assert  dic.Item( "Key2" ) = "ITEMS"
  Assert  dic.Item( "Key3" ) = "Item3"
サンプル
ソース
→ vbslib.vbs